home *** CD-ROM | disk | FTP | other *** search
/ Mac Mania 2 / MacMania 2.toast / Demo's / Tools&Utilities / Updaters / Frontier 2.0 => 2.0.1 Upgrader / Install Files / DocServer Docs / file.getSpecialFolderPath < prev    next >
Encoding:
Text File  |  1993-02-25  |  1.6 KB  |  31 lines  |  [TEXT/DOCS]
  1.  
  2. Verb    file.getSpecialFolderPath
  3. Syntax    file.getSpecialFolderPath (vol, folder, create)
  4. Parameters    vol is the name of the volume on which the special folder’s location is to be determined. If vol is the empty string, the current boot disk is used.
  5. folder is the standard U. S. name of the special folder whose path is to be determined. Possible values are:
  6.     • "Apple Menu Items"
  7.     • "Control Panels"
  8.     • "Desktop Folder"
  9.     • "Extensions"
  10.     • "Fonts"
  11.     • "Preferences"
  12.     • "PrintMonitor Documents"
  13.     • "Startup Items"
  14.     • "System Folder"
  15.     • "Temporary Items"
  16.     • "Trash"
  17. create is a boolean value indicating whether or not the desired folder should be created if it doesn’t exist on vol.
  18. Action    Looks on the indicated volume for the special folder, and creates it if necessary.
  19. Returns    The full path name of the requested folder.
  20. Examples    file.getSpecialFolderPath ("", "System", false)
  21.     » System:System Folder:
  22. This call is equivalent to file.getSystemFolderPath
  23.  
  24. file.getSpecialFolderPath ("Misc:", "Temporary Items", true)
  25.     » Misc:Järjestelmäkansio:Omenavalikko:  «the Finnish version of System 7.0.1 is running.
  26. If the folder did not exist before the call, it was created.]
  27. Errors    • If the folder parameter is not valid, or the requested folder could not be found or created, an error is generated.
  28. • If the desired folder belongs in the System Folder and the volume does not contain a System Folder, no System Folder will be created, and an error will occur.
  29. Notes    Case is not significant in the folder parameter, and the word “Items” or “Folder” may be left out of those names in which it appears.
  30. See Also    file.getSystemFolderPath
  31.